package net.zoneland.zrdp.framework.web.service;

import net.zoneland.oadocs.sdk.pojo.DocCreateRequest;
import net.zoneland.oadocs.sdk.pojo.DocDetailInfo;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.util.List;

/**
 * 后台附件操作服务接口类.
 * @since 2020/9/16
 **/
public interface WpsAttachmentService {

    /**
    * 获取最新的appKey.
    * @author pbody
    * @param oldAppKey 老的appKey
    * @return java.lang.String
    */
    String getNewAppKey(final String oldAppKey);

    /**
     * 获取当前的appKey.
     * @return java.lang.String
     */
    String getCurrentAppKey();

    /**
     * 根据目录id获取该id其下所有的文件. 包含子目录的文件
     * @param folderId 目录ID
     * @return  结果list
     */
    List<DocDetailInfo> getAttachmentsByPid(final String folderId);

    /**
     * 上传附件.
     *
     * @param file 附件
     * @param attachmentName 附件名称
     * @return java.lang.String wps上的文件id
     * @throws java.io.IOException 异常
     */
    String upload(final MultipartFile file, String attachmentName) throws IOException;

    /**
     * 创建文件或者文件夹
     * @param createRequest 需要创建的信息
     * @return 文件或文件夹的id
     */
    String createFileOrFolder(final DocCreateRequest createRequest);
}
